home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / X11 / XLookupKeysym.z / XLookupKeysym
Encoding:
Text File  |  2001-04-17  |  7.9 KB  |  199 lines
  1.  
  2.  
  3.  
  4.      XXXXLLLLooooooookkkkuuuuppppKKKKeeeeyyyyssssyyyymmmm((((3333XXXX11111111))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333)))) XXXXLLLLooooooookkkkuuuuppppKKKKeeeeyyyyssssyyyymmmm((((3333XXXX11111111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XLookupKeysym, XRefreshKeyboardMapping, XLookupString,
  10.           XRebindKeySym - handle keyboard input events in Latin-1
  11.  
  12.      SSSSYYYYNNNNTTTTAAAAXXXX
  13.           KeySym XLookupKeysym(_k_e_y__e_v_e_n_t, _i_n_d_e_x)
  14.                 XKeyEvent *_k_e_y__e_v_e_n_t;
  15.                 int _i_n_d_e_x;
  16.  
  17.           XRefreshKeyboardMapping(_e_v_e_n_t__m_a_p)
  18.                 XMappingEvent *_e_v_e_n_t__m_a_p;
  19.  
  20.           int XLookupString(_e_v_e_n_t__s_t_r_u_c_t, _b_u_f_f_e_r__r_e_t_u_r_n, _b_y_t_e_s__b_u_f_f_e_r,
  21.           _k_e_y_s_y_m__r_e_t_u_r_n, _s_t_a_t_u_s__i_n__o_u_t)
  22.                 XKeyEvent *_e_v_e_n_t__s_t_r_u_c_t;
  23.                 char *_b_u_f_f_e_r__r_e_t_u_r_n;
  24.                 int _b_y_t_e_s__b_u_f_f_e_r;
  25.                 KeySym *_k_e_y_s_y_m__r_e_t_u_r_n;
  26.                 XComposeStatus *_s_t_a_t_u_s__i_n__o_u_t;
  27.  
  28.           XRebindKeysym(_d_i_s_p_l_a_y, _k_e_y_s_y_m, _l_i_s_t, _m_o_d__c_o_u_n_t, _s_t_r_i_n_g,
  29.           _n_u_m__b_y_t_e_s)
  30.                 Display *_d_i_s_p_l_a_y;
  31.                 KeySym _k_e_y_s_y_m;
  32.                 KeySym _l_i_s_t[];
  33.                 int _m_o_d__c_o_u_n_t;
  34.                 unsigned char *_s_t_r_i_n_g;
  35.                 int _n_u_m__b_y_t_e_s;
  36.  
  37.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  38.           _b_u_f_f_e_r__r_e_t_u_r_n
  39.                     Returns the translated characters.
  40.  
  41.           _b_y_t_e_s__b_u_f_f_e_r
  42.                     Specifies the length of the buffer.  No more than
  43.                     bytes_buffer of translation are returned.
  44.  
  45.           _n_u_m__b_y_t_e_s Specifies the number of bytes in the string
  46.                     argument.
  47.  
  48.           _d_i_s_p_l_a_y   Specifies the connection to the X server.
  49.  
  50.           _e_v_e_n_t__m_a_p Specifies the mapping event that is to be used.
  51.  
  52.           _e_v_e_n_t__s_t_r_u_c_t
  53.                     Specifies the key event structure to be used.  You
  54.                     can pass _X_K_e_y_P_r_e_s_s_e_d_E_v_e_n_t or _X_K_e_y_R_e_l_e_a_s_e_d_E_v_e_n_t.
  55.  
  56.           _i_n_d_e_x     Specifies the index into the KeySyms list for the
  57.                     event's KeyCode.
  58.  
  59.           _k_e_y__e_v_e_n_t Specifies the _K_e_y_P_r_e_s_s or _K_e_y_R_e_l_e_a_s_e event.
  60.  
  61.  
  62.  
  63.      Page 1                                           (printed 4/6/01)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXLLLLooooooookkkkuuuuppppKKKKeeeeyyyyssssyyyymmmm((((3333XXXX11111111))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333)))) XXXXLLLLooooooookkkkuuuuppppKKKKeeeeyyyyssssyyyymmmm((((3333XXXX11111111))))
  71.  
  72.  
  73.  
  74.           _k_e_y_s_y_m    Specifies the KeySym that is to be rebound.
  75.  
  76.           _k_e_y_s_y_m__r_e_t_u_r_n
  77.                     Returns the KeySym computed from the event if this
  78.                     argument is not NULL.
  79.  
  80.           _l_i_s_t      Specifies the KeySyms to be used as modifiers.
  81.  
  82.           _m_o_d__c_o_u_n_t Specifies the number of modifiers in the modifier
  83.                     list.
  84.  
  85.           _s_t_a_t_u_s__i_n__o_u_t
  86.                     Specifies or returns the _X_C_o_m_p_o_s_e_S_t_a_t_u_s structure
  87.                     or NULL.
  88.  
  89.           _s_t_r_i_n_g    Specifies the string that is copied and will be
  90.                     returned by _X_L_o_o_k_u_p_S_t_r_i_n_g.
  91.  
  92.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  93.           The _X_L_o_o_k_u_p_K_e_y_s_y_m function uses a given keyboard event and
  94.           the index you specified to return the KeySym from the list
  95.           that corresponds to the KeyCode member in the
  96.           _X_K_e_y_P_r_e_s_s_e_d_E_v_e_n_t or _X_K_e_y_R_e_l_e_a_s_e_d_E_v_e_n_t structure.  If no
  97.           KeySym is defined for the KeyCode of the event,
  98.           _X_L_o_o_k_u_p_K_e_y_s_y_m returns _N_o_S_y_m_b_o_l.
  99.  
  100.           The _X_R_e_f_r_e_s_h_K_e_y_b_o_a_r_d_M_a_p_p_i_n_g function refreshes the stored
  101.           modifier and keymap information.  You usually call this
  102.           function when a _M_a_p_p_i_n_g_N_o_t_i_f_y event with a request member of
  103.           _M_a_p_p_i_n_g_K_e_y_b_o_a_r_d or _M_a_p_p_i_n_g_M_o_d_i_f_i_e_r occurs.  The result is to
  104.           update Xlib's knowledge of the keyboard.
  105.  
  106.           The _X_L_o_o_k_u_p_S_t_r_i_n_g function translates a key event to a
  107.           KeySym and a string.  The KeySym is obtained by using the
  108.           standard interpretation of the _S_h_i_f_t, _L_o_c_k, group, and
  109.           numlock modifiers as defined in the X Protocol
  110.           specification.  If the KeySym has been rebound (see
  111.           _X_R_e_b_i_n_d_K_e_y_s_y_m), the bound string will be stored in the
  112.           buffer.  Otherwise, the KeySym is mapped, if possible, to an
  113.           ISO Latin-1 character or (if the Control modifier is on) to
  114.           an ASCII control character, and that character is stored in
  115.           the buffer.  _X_L_o_o_k_u_p_S_t_r_i_n_g returns the number of characters
  116.           that are stored in the buffer.
  117.  
  118.           If present (non-NULL), the _X_C_o_m_p_o_s_e_S_t_a_t_u_s structure records
  119.           the state, which is private to Xlib, that needs preservation
  120.           across calls to _X_L_o_o_k_u_p_S_t_r_i_n_g to implement compose
  121.           processing.  The creation of _X_C_o_m_p_o_s_e_S_t_a_t_u_s structures is
  122.           implementation-dependent; a portable program must pass NULL
  123.           for this argument.
  124.  
  125.           The _X_R_e_b_i_n_d_K_e_y_s_y_m function can be used to rebind the meaning
  126.  
  127.  
  128.  
  129.      Page 2                                           (printed 4/6/01)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXLLLLooooooookkkkuuuuppppKKKKeeeeyyyyssssyyyymmmm((((3333XXXX11111111))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333)))) XXXXLLLLooooooookkkkuuuuppppKKKKeeeeyyyyssssyyyymmmm((((3333XXXX11111111))))
  137.  
  138.  
  139.  
  140.           of a KeySym for the client.  It does not redefine any key in
  141.           the X server but merely provides an easy way for long
  142.           strings to be attached to keys.  _X_L_o_o_k_u_p_S_t_r_i_n_g returns this
  143.           string when the appropriate set of modifier keys are pressed
  144.           and when the KeySym would have been used for the
  145.           translation.  No text conversions are performed; the client
  146.           is responsible for supplying appropriately encoded strings.
  147.           Note that you can rebind a KeySym that may not exist.
  148.  
  149.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  150.           XButtonEvent(3X11), XMapEvent(3X11), XStringToKeysym(3X11)
  151.           _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                           (printed 4/6/01)
  196.  
  197.  
  198.  
  199.